home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / xscreensaver-command.1 < prev    next >
Text File  |  1995-07-25  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xscreensaver-command - control a running xscreensaver
  10.           process
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           xxxxssssccccrrrreeeeeeeennnnssssaaaavvvveeeerrrr----ccccoooommmmmmmmaaaannnndddd [-activate] [-deactivate] [-cycle]
  14.           [-next] [-prev] [-exit] [-restart] [-demo] [-lock]
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           The _x_s_c_r_e_e_n_s_a_v_e_r-_c_o_m_m_a_n_d program controls a running
  18.           _x_s_c_r_e_e_n_s_a_v_e_r process by sending it client-messages.
  19.  
  20.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  21.           _x_s_c_r_e_e_n_s_a_v_e_r-_c_o_m_m_a_n_d accepts the following options:
  22.  
  23.           ----aaaaccccttttiiiivvvvaaaatttteeee
  24.                   Tell the screensaver to turn on immediately (that
  25.                   is, pretend that the user been idle for long
  26.                   enough.)  It will turn off as soon as there is any
  27.                   user activity, as usual.
  28.  
  29.                   It is useful to run this from a menu; you may wish
  30.                   to run it as
  31.  
  32.                        sleep 5 ; xscreensaver-command -activate
  33.  
  34.                   to be sure that you have time to remove your hand
  35.                   from the mouse before the screensaver comes on.
  36.  
  37.           ----ddddeeeeaaaaccccttttiiiivvvvaaaatttteeee
  38.                   Tell the screensaver to turn off, as if there had
  39.                   been user activity.  If locking is enabled, then the
  40.                   screensaver will prompt for a password as usual.
  41.  
  42.           ----ccccyyyycccclllleeee  Tell the screensaver to change which graphics hack
  43.                   it is running, just as if the ``cycle'' timer had
  44.                   expired.
  45.  
  46.           ----nnnneeeexxxxtttt   This is like either -_a_c_t_i_v_a_t_e or -_c_y_c_l_e, depending
  47.                   on which is more appropriate, except that the
  48.                   screenhack that will be run is the next one in the
  49.                   list of programs, instead of a randomly-chosen one.
  50.                   This option is good for looking at a demo of each of
  51.                   the screensavers currently available.  You might
  52.                   want to put this on a menu.
  53.  
  54.           ----pppprrrreeeevvvv   This is like -_n_e_x_t, but cycles in the other
  55.                   direction.
  56.  
  57.           ----ddddeeeemmmmoooo   Cause the screensaver to enter its interactive demo
  58.                   mode, if it has been compiled with support for it.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  71.  
  72.  
  73.  
  74.           ----lllloooocccckkkk   Like -_a_c_t_i_v_a_t_e, but a password will be required
  75.                   before the screensaver turns off, even if the
  76.                   screensaver's _l_o_c_k resource is false.  The display
  77.                   will be locked immediately even if the screensaver's
  78.                   _l_o_c_k_T_i_m_e_o_u_t resource is non-zero.
  79.  
  80.           ----eeeexxxxiiiitttt   Causes the screensaver process to exit gracefully.
  81.                   This is a slightly safer way to kill the screensaver
  82.                   than by using _k_i_l_l.
  83.  
  84.                   Never use _k_i_l_l -_9 with _x_s_c_r_e_e_n_s_a_v_e_r while the
  85.                   screensaver is active.  If you are using a virtual
  86.                   root window manager, that can leave things in an
  87.                   inconsistent state, and you may need to restart your
  88.                   window manager to repair the damage.
  89.  
  90.           ----rrrreeeessssttttaaaarrrrtttt
  91.                   Causes the screensaver process to exit and then
  92.                   restart with the same command line arguments.  This
  93.                   is a good way of causing the screensaver to re-read
  94.                   the resource database.
  95.  
  96.                   If the screensaver is run from _x_d_m(_1) (that is, it
  97.                   is already running before you log in) then you may
  98.                   want to issue the ``restart'' command from one of
  99.                   your startup scripts, so that the screensaver gets
  100.                   your resource settings instead of the default ones.
  101.  
  102.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  103.           DDDDIIIISSSSPPPPLLLLAAAAYYYY to get the default host and display number.
  104.  
  105.           PPPPAAAATTTTHHHH    to find the executable to restart.
  106.  
  107.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.           XXXX(1), xxxxssssccccrrrreeeeeeeennnnssssaaaavvvveeeerrrr(1)
  109.  
  110.      BBBBUUUUGGGGSSSS
  111.           Diagnostics are reported on the ssssttttddddeeeerrrrrrrr of the _x_s_c_r_e_e_n_s_a_v_e_r
  112.           process, not this process, so the caller of _x_s_c_r_e_e_n_s_a_v_e_r-
  113.           _c_o_m_m_a_n_d may not see the error messages.
  114.  
  115.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  116.           Copyright c 1992, 1993 by Jamie Zawinski.  Permission to
  117.           use, copy, modify, distribute, and sell this software and
  118.           its documentation for any purpose is hereby granted without
  119.           fee, provided that the above copyright notice appear in all
  120.           copies and that both that copyright notice and this
  121.           permission notice appear in supporting documentation.  No
  122.           representations are made about the suitability of this
  123.           software for any purpose.  It is provided "as is" without
  124.           express or implied warranty.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  137.  
  138.  
  139.  
  140.      AAAAUUUUTTTTHHHHOOOORRRR
  141.           Jamie Zawinski <jwz@mcom.com>, 13-aug-92.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/30/95)
  196.  
  197.  
  198.  
  199.